If you give me a good use case I'll merge it 😉

The use case you gave is not a good one! It already has a solution:

TAntiban = record  
  //...
  //...
  OnStartTask,  OnFinishTask:  procedure(task: PAntibanTask) of object;
  OnStartBreak, OnFinishBreak: procedure(task: PBreakTask)   of object;
  OnStartSleep, OnFinishSleep: procedure(task: PSleepTask)   of object;
  //...
  //...
end;

And this solution is better because what you are suggesting for the scripter to know there's a break coming is misleading.
A break can be due but it will never happen unless the scripter calls Antiban.DoAntiban().

The built-in approach however runs every time at the start of the task, break or sleep when you are actually going to do it for sure and as a bonus you also have OnFinish callbacks to restore your script properly if you need.

TimeUntilBreak and TimeUntilSleep is awkward to use programatically because they are not meant to be used programatically. They are meant to show a string to users. What you want is the OnStart callbacks

this is how i check if a break, task or sleep would be called if i called Antiban.Do

var
  i: Int32;
  activeTasks: PAntibanTaskArray;
begin
  if Self.DoingAntiban then
    Exit(False);

  activeTasks := Self.GetActiveTasks();
  for i := 0 to High(activeTasks) do
    if activeTasks[i]^.Countdown.Remaining = 0 then
      Exit(True);

  Result := False;
end;


function TAntiban.BreakDue(): Boolean;
var
  i: Int32;
  t: UInt64;
begin
  if Self.DoingAntiban then
    Exit(False);

  t := GetTimeRunning();
  for i := 0 to High(Self.Breaks) do
    if t > Self.Breaks[i].Next then
      Exit(True);

  Result := False;
end;


function TAntiban.SleepDue(): Boolean;
var
  i: Int32;
  t: UInt64;
begin
  if Self.DoingAntiban then
    Exit(False);

  t := GetTimeRunning();
  for i := 0 to High(Self.Sleeps) do
    if t > Self.Sleeps[i].Next then
      Exit(True);

  Result := False;
end;

I use that to set my state, and then call the specific antiban so my script state updates first.

@Torwent @phron3sis
I'm good to close this out. The existing solutions make sense to me but were missing from the docs and I hadn't checked what was available to me within Antiban.

I appreciate the feedback, I may do a PR to add docstrings to these and clarify some of this for those who come after me :)

Thx!